

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>Expansion Region [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, Element,Element Expansion Region,Element Region, Expansion,Expansion Region,Expansion Region Element,Region,Region Expansion, Element">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">Expansion Region</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="exception.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="addexpansionregion.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_TextIndentedL2"><img src="d_region.png" width="117" height="81" border="0" alt="d_region"></p>
<p class="p_BodyText"><span class="f_BodyText">You <a href="addexpansionregion.htm">create</a> an </span><span class="f_BodyText" style="font-style: italic;">Expansion Region</span><span class="f_BodyText"> as one variant of a </span><span class="f_BodyText" style="font-style: italic;"><a href="region.htm">Region</a></span><span class="f_BodyText"> (the other is an </span><span class="f_BodyText" style="font-style: italic;"><a href="interruptibleactivityregion.htm">Interruptible Activity Region</a></span><span class="f_BodyText">).</span></p>
<p class="p_BodyText"><span class="f_BodyText">On an <a href="activitydiagram.htm">Activity diagram</a>, an </span><span class="f_BodyText">Expansion Region</span><span class="f_BodyText"> surrounds a process to be imposed multiple times on the incoming data, once for every element in the input collection. If there are multiple inputs, the collection sizes must match, and the elements within each collection must be of the same type. Similarly, any outputs must be in the form of a collection matching the size of the inputs.</span></p>
<p class="p_BodyText"><span class="f_BodyText">The concurrency of the Expansion Region's multiple executions can be specified as type </span><span class="f_BodyText" style="font-style: italic;">parallel</span><span class="f_BodyText">, </span><span class="f_BodyText" style="font-style: italic;">iterative</span><span class="f_BodyText">, or </span><span class="f_BodyText" style="font-style: italic;">stream</span><span class="f_BodyText">. Parallel reflects that the elements in the incoming collections can be processed at the same time or overlapping, whereas an iterative concurrency type specifies that execution must occur sequentially. A stream-type Expansion Region indicates that the input and output come in and exit as streams, and that the Expansion Region's process must have some method to support streams.</span></p>
<p class="p_BodyText"><span class="f_BodyText">To modify the mode of an Expansion Region, right-click on it and select the </span><span class="f_MenuKeyField">Advanced | Custom Properties</span><span class="f_BodyText"> menu option.</span></p>
<p class="p_TextIndentedL2"><img src="activity%20-%20expansionregion.png" width="528" height="706" border="0" alt="Activity - ExpansionRegion"></p>
<p class="p_BodyText"><span class="f_BodyText">See </span><span class="f_BodyText" style="font-style: italic;">UML Superstructure Specification, v2.1.1, figure 12.87, p. 372</span><span class="f_BodyText">.</span></p>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Toolbox Icon</span></p>
<p class="p_TextIndentedL2"><img src="e_region.png" width="168" height="20" border="0" alt="e_Region"></p>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">OMG UML Specification</span><span class="f_SubHeadingL1"> </span></p>
<p class="p_BodyText"><span class="f_BodyText">The OMG UML specification (</span><span class="f_BodyText" style="font-style: italic;">UML Superstructure Specification, v2.1.1, p. 367</span><span class="f_BodyText">) states:</span></p>
<p class="p_OMGText"><span class="f_OMGText">An expansion region is a structured activity region that executes multiple times corresponding to elements of an input collection.</span></p>




            </div>
          </div>
        </div>



</div>


</body>
</html>
